Skip to content

Add agent when-to-use guidance to llms.txt plus homepage/contact markdown twins - #52

Open
RobbieTheWagner wants to merge 1 commit into
mainfrom
agent-ready/llms-guidance
Open

Add agent when-to-use guidance to llms.txt plus homepage/contact markdown twins#52
RobbieTheWagner wants to merge 1 commit into
mainfrom
agent-ready/llms-guidance

Conversation

@RobbieTheWagner

Copy link
Copy Markdown
Member

Part of the agent-readiness work (Is Agentic audit): tells agents when to use the site and gives them named, predictable entry points.

  • llms.txt (and the for-llms page) now open with a "When To Use This Site" section naming best-fit jobs — find/quote episodes, transcripts, guest appearances, listening links — and how to fetch machine-readable content, plus an explicit "do not use for unrelated topics" line
  • New "Developer Resources" section listing the OpenAPI spec, JSON APIs, sitemap, and RSS feed by name for discoverability
  • New markdown twins: /index.html.md (homepage) and /contact.html.md, generated from config like the existing ones
  • robots.txt mentions the OpenAPI spec and Accept-header markdown support

All content is generated from starpod.config.ts and the RSS feed — generic for every Starpod deployment.

Test plan

  • Unit: expanded tests/unit/llms.test.ts for the new sections and generators
  • E2E: tests/e2e/llms.spec.ts verifies llms.txt sections and both new markdown twins

🤖 Generated with Claude Code

…down twins

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
starpod Ready Ready Preview Aug 23, 2026 2:57pm

Request Review

@coderabbitai

coderabbitai Bot commented Aug 23, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@RobbieTheWagner, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 7 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 30648144-c53c-4af1-b28b-3616bd407898

📥 Commits

Reviewing files that changed from the base of the PR and between 80e49fe and 12ac7fd.

📒 Files selected for processing (6)
  • src/lib/llms.ts
  • src/pages/contact.html.md.ts
  • src/pages/index.html.md.ts
  • src/pages/robots.txt.ts
  • tests/e2e/llms.spec.ts
  • tests/unit/llms.test.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant